home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / X11 / viola-3.3 / README_SETUP_3.3 < prev    next >
Text File  |  1995-07-08  |  3KB  |  100 lines
  1. Compiling and Running ViolaWWW
  2. ==============================
  3.  
  4. To compile, type 'BUILD' to run the compilation script. If the compilation
  5. process goes well, two executable program binaries will be generated
  6. and they can be found in:
  7.  
  8.     viola/src/viola/viola        <-- the pure XLib version
  9.     viola/src/vw/vw            <-- the Motif version
  10.  
  11.  
  12. The 'viola' binary (in src/viola/viola) is the XLib-only version of
  13. ViolaWWW. It is provided because not everyone has Motif. Also, this 
  14. binary version is smaller. However, the GUIs on the Motif version of 
  15. viola is still more polished. 'vw' (in src/vw/vw) is the ViolaWWW 
  16. with the Motif shell. 
  17.  
  18. If you do not have Motif installed on your system, the 'vw' binary
  19. will simply fail to build, but the production of the 'viola' binary 
  20. should not be affected.
  21.  
  22. This package requires X11R5, and the Motif version of ViolaWWW 
  23. requires a Motif toolkit library. The libwww(2.14) that comes with 
  24. ViolaWWW is modified, so until the changes are integrated into CERN's, 
  25. don't use the libwww that didn't come with viola.
  26.  
  27. I'd appreciate hearing about compilation success or horror stories 
  28. (and get patches) for platforms other than SunOS and Ultrix.
  29.  
  30.  
  31. Installing ViolaWWW
  32. ===================
  33.  
  34. Both binaries can be installed anywhere in your path.
  35.  
  36. To ensure that the colors come out decent, insert the following 
  37. XWindows Resource into your "~/.Xdefaults" file. 
  38.  
  39. ------------------------------------------
  40. Viola.x:        550
  41. Viola.y:        10
  42. Viola.width:        620
  43. Viola.height:        700
  44. #ifdef COLOR
  45. Viola*foreground:    black
  46. Viola*background:    grey80
  47. Viola.foreground_doc:    black
  48. Viola.background_doc:    grey90
  49. #else
  50. Viola*foreground:    white
  51. Viola*background:    black
  52. Viola*borderColor:    white
  53. #endif
  54. ------------------------------------------
  55.  
  56. Then do this to update the X resources, to let it take effect:
  57. % xrdb -load ~/.Xresources
  58.  
  59.  
  60. Running ViolaWWW
  61. ================
  62.  
  63. Both ViolaWWW programs can take the start up document URL as an argument, 
  64. thusly:
  65.  
  66. % viola [url]
  67. % vw [url]
  68.  
  69. If you do not supply any argument, the default URL is taken from 
  70. the WWW_HOME environment variable. In liu of WWW_HOME, the fall back
  71. URL is "http://berkeley.ora.com/proj/viola/violaHome.html"
  72.  
  73.  
  74. Contact
  75. =======
  76.  
  77. You can send mail to viola@ora.com. Feedbacks, bug reports, patches, 
  78. constructive criticisms, etc, are always welcome. Let me offer my 
  79. sincere apologies, in advance, in case I do not get back to you promptly--
  80. I am the whole viola development team, and I do have other things 
  81. to attend to... but I will try to be prompt.
  82.  
  83.  
  84. Acknowledgements
  85. ================
  86.  
  87. In particular, many thanks to: Tim Bernners-Lee for inventing the WWW;
  88. Tim and the CERN crew for the libwww; All the contributors on www-talk etc;
  89. Jon Blow (ORA) for the lexical analyzer used in viola; Scott Silvey (ORA)
  90. for creating the Motif front-end; Terry Allen (ORA) for lots of testings 
  91. and help with SGML; Dale Dougherty and Tim O'Reilly for supporting the 
  92. work on viola at ORA. 
  93.  
  94. Also, grateful thanks are extended to the brave beta testers, listed in
  95. "http://xcf.berkeley.edu/ht/projects/viola/betaTesters.html".
  96.  
  97.  
  98.                 Pei Y. Wei (wei@ora.com)
  99.                 O'Reilly & Associates, Inc.
  100.